home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1993 July / InfoMagic USENET CD-ROM July 1993.ISO / sources / misc / volume15 / dmake-3.6 / part00 next >
Encoding:
Text File  |  1990-10-14  |  13.5 KB  |  312 lines
  1. Newsgroups: comp.sources.misc
  2. X-UNIX-From: dvadura@watdragon.waterloo.edu
  3. subject: v15i052: dmake version 3.6 (part 00/25)
  4. from: Dennis Vadura <dvadura@watdragon.waterloo.edu>
  5. Sender: allbery@uunet.UU.NET (Brandon S. Allbery - comp.sources.misc)
  6.  
  7. Posting-number: Volume 15, Issue 52
  8. Submitted-by: Dennis Vadura <dvadura@watdragon.waterloo.edu>
  9. Archive-name: dmake-3.6/part00
  10.  
  11. #!/bin/sh
  12. # This is the DMAKE version 3.6 distribution.  DMAKE is a Make like tool that
  13. # has been written by me and has been used by individuals at the University of
  14. # Waterloo for about a year and a half now.  This release replaces the previous
  15. # version 3.5 release which is no longer supported.  Please read the file
  16. # 'readme/release' which accompanies this distribution and describes details
  17. # of this release (This note is found in readme/cover).
  18. #
  19. # This release addresses a claim made by Mortice Kern Systems of Waterloo,
  20. # Ontario, Canada.  See below or the file readme/release for details.  I
  21. # therefore ask that all versions previous versions of dmake distributed as
  22. # version 3.5 patch level 1 and patch level 2 be removed from any archive
  23. # sites on which they reside and be replaced by this release.
  24. # 
  25. # dmake is available for anonymous ftp from watmsg.uwaterloo.ca address is
  26. # 129.97.129.9.  It is in the pub/src directory, set your mode to binary,
  27. # and copy either:
  28. # 
  29. #     dmake-3.6.tar.Z        - compressed tar format
  30. #     dmake-3.6.zoo        - zoo archive
  31. # 
  32. # dmake is different from other versions of make in that it supports significant
  33. # enhancements (See the man page).  A short summary of the more important
  34. # ones follows:
  35. # 
  36. #     . support for portable makefiles
  37. #     . runs on many platforms (DOS, generic unix [sysv and bsd4.3],
  38. #       apollo, and others)
  39. #     . significantly enhanced macro facilities
  40. #     . transitive closure on inference graph
  41. #     . sophisticated inference algorithm
  42. #     . support for traversing the file sytem both during making of targets
  43. #       and during inference
  44. #     . %-meta rules for specifying rules to be used for inferring
  45. #       prerequisites
  46. #     . highly configurable
  47. #     . support for libraries
  48. #     . parallel making of targets on architectures that support it
  49. #     . attributed targets
  50. #     . text diversions
  51. #     . group recipes
  52. #     . swapping itself to DISK under MSDOS
  53. #     . supports MKS extended argument passing convention
  54. # 
  55. # All code found in this distribution is original and written by me except where
  56. # noted in the source and the following:
  57. # 
  58. # - dbug package from Fred Fish  (dmake DEBUG=1, to make a debugging version
  59. #   of dmake)
  60. # 
  61. # - malloc.c package, came from the net originally, author name wasn't
  62. #   on it when I found it, I can't even remember where I got it.
  63. # -----------------------------------------------------------------------------
  64. # 
  65. # DMAKE VERSION 3.6 RELEASE NOTES  (readme/release file in distribution):
  66. # 
  67. # MANDATORY REPLACEMENT FOR VERSION 3.5 PATCH LEVEL 1 and PATCH LEVEL 2
  68. # 
  69. # Nature:   This version of dmake MUST replace all versions of dmake 3.5 patch
  70. # -------   levels 1 and 2, and all versions of dmake 3.5 patch level 1 and 2
  71. #           must then be DELETED.  This release addresses several issues.
  72. # 
  73. #         1. Copyright infringement claim made by MKS, of Waterloo.
  74. #         2. Modifications to text diversion processing.
  75. #         3. Support for DOS Swapping, and MKS argument passing.
  76. #         4. Other minor nits and tweaks.
  77. # 
  78. #       This distribution advances dmake to Version 3.6, patch level 1.  This
  79. #       version is certified free of MKS copyrighted code.  See below for
  80. #       details.
  81. #           
  82. # Availability:
  83. # -------------
  84. #       dmake is available via anonymous ftp from watmsg.uwaterloo.edu
  85. #       (129.97.129.9) as:
  86. # 
  87. #          pub/src/dmake-3.6.tar.Z
  88. #          pub/src/dmake-3.6.zoo 
  89. # 
  90. #       and comes in either a compressed tar or zoo archive take your pick.
  91. # 
  92. # Acknowledgements:
  93. # -----------------
  94. #       Thanks to all who submitted code for new features, suggestions for
  95. #       improvements, and bug fixes.  Special thanks to those who helped
  96. #       test this version of dmake on the many platforms that the
  97. #       distribution now supports.  I have tried to make sure no gotchas
  98. #       remain, if you encounter problems installing or running dmake please
  99. #       let me know.  As always, I am always happy to receive e-mail.
  100. # 
  101. # 
  102. # DETAILS OF CHANGES:
  103. # ===================
  104. # 
  105. # MKS Copyright Infringement:
  106. # ---------------------------
  107. #    Due to a misunderstanding over past contractual obligations between
  108. #    myself and Mortice Kern Systems of Waterloo, Ontario, Canada (MKS),
  109. #    the original posting of dmake unitentionally contains some code
  110. #    derived from MKS proprietary code.
  111. # 
  112. #    This version rectifies that situation and MUST replace all versions
  113. #    of DMAKE and DMAKE patches that have been previously distributed.
  114. #    Please delete from any archive site versions of DMAKE source code
  115. #    labeled 3.5 patch level 1 or patch level 2 and dmake 3.5 patch 1.
  116. # 
  117. #    Version 3.6 of the dmake source replaces *ALL* MKS proprietary code.
  118. #    In particular, putenv.c in the bsd43 and sysvr1 directories is new.
  119. #    Three routines in percent.c;  Add_dfa, Construct_dfa, and Advance_dfa
  120. #    have been replaced.  Lastly, TEXT DIVERSION processing has been removed
  121. #    from make.c and <+...+> constructions are replaced by the $(mktmp ...)
  122. #    construct (see below for more details).  The changes relating to the
  123. #    above mentioned modifications have been reviewed by MKS and certified by
  124. #    MKS to be free of MKS proprietary code.  The note below is from MKS
  125. #    and releases dmake version 3.6 patch level 1 from any MKS copyright
  126. #    infringement claims.
  127. # 
  128. #     "MKS has reviewed the latest sources, as of 90.09.20,
  129. #      for the files make.c, putenv.c, and percent.c, which
  130. #      are part of the program dmake version 3.6, and found
  131. #      these files to be free of MKS proprietary source code."
  132. # 
  133. #    No functionality is lost as a result of these changes, however
  134. #    certain constructs may have to be expressed using a new syntax.  See
  135. #    the documentation and the comments below for details.
  136. # 
  137. # 
  138. # Text Diversion Processing:
  139. # --------------------------
  140. #    As alluded to above, the <+...+> text diversion facility has been
  141. #    officially replaced by a new facility of the form $(mktmp ...) details of
  142. #    which may be found in the TEXT DIVERSION section of the documentation.
  143. #    Briefly, the construct:
  144. # 
  145. #         exe:; link @<+$(OBJFILES:t"+\n")+>
  146. # 
  147. #    is replaced by:
  148. # 
  149. #         exe:; link @$(mktmp $(OBJFILES:t"+\n"))
  150. # 
  151. #    similarly the construct:
  152. # 
  153. #         all :
  154. #                 echo hi <+
  155. #                 line1
  156. #                 line2 +>
  157. # 
  158. #    is replaced by:
  159. # 
  160. #         all :
  161. #                 echo hi $(mktmp\
  162. #                 line1\n\
  163. #                 line2)
  164. # 
  165. #    where the \n\ is added to the end of each line within the data portion of
  166. #    the $(mktmp ...) construction.  For a number of reasons it is my belief
  167. #    that this new construct is a better implementation of text diversions than
  168. #    the previous <+...+> as it can be used in macro expressions that appear
  169. #    anywhere in the makefile.
  170. # 
  171. #    Compatibility is retained for previous versions of dmake that utilize
  172. #    a simple form of the <+...+> construct.  If your <+...+> constructs do not
  173. #    span multiple lines (cf second example above), then the new version of
  174. #    dmke will recognize these and will map them to the appropriate
  175. #    $(mktmp ...) construct.  Thus, If you use <+...+> and you do not allow the
  176. #    interior data to span multiple lines and both <+ and +> appear as clear
  177. #    text in the same recipe line or macro value, then dmake will process these
  178. #    correctly and the output is 100% compatible to version 3.5 patch level 2.
  179. #    Any other use of <+...+> must be converted to the new $(mktmp ...) form.
  180. # 
  181. #    The new form also provides for massaging the name of the temporary file
  182. #    which replaces the text in the recipe.  See the documentation regarding
  183. #    the special macros USESHELL, TMPFILE, and DIVSHELL.  This is of most use
  184. #    in an MSDOS environment.
  185. # 
  186. # 
  187. # DOS Swapping, and MKS argument passing:
  188. # ---------------------------------------
  189. #    dmake now supports swapping the executable image to secondary storage when
  190. #    it executes a child.  Swapping is enabled by setting the new attribute
  191. #    .SWAP to on, either for a target or globally, or by specifying the '%'
  192. #    modifier to a recipe line.  So for example:
  193. # 
  194. #     xx .SWAP :; recipe
  195. # 
  196. #    and
  197. # 
  198. #     xx :;% recipe
  199. # 
  200. #    are equivalent.
  201. # 
  202. #    The MKS DOS argument passing conventions are now supported, and dmake is
  203. #    able to communicate with programs that understand those conventions.  The
  204. #    global variable .MKSARGS is used to enable/disable this facility.  With
  205. #    these modifications, dmake now supports long command lines for running
  206. #    commands that understand the MKS argument passing convention, and it does
  207. #    not run into memory limitations when executing child processes in most
  208. #    situations.
  209. # 
  210. #    Both .SWAP and .MKSARGS are ignored by non-MSDOS versions of dmake.
  211. #    See the manual page for further details.
  212. # 
  213. # 
  214. # Other tweaks modifications and BUG FIXES:
  215. # -----------------------------------------
  216. # -- Slight modifications to msdos/startup.mk files.  Set DIRSEPSTR to \
  217. #    if using command.com as the shell, otherwise set internaly to /.
  218. #    Removed -o $@ from MSC startup.mk, and added $(ASFLAGS) to %$O : %$S
  219. #    rule, in all default DOS startup.mk files.
  220. # 
  221. # -- Added POSIX '+' character to start of recipe lines.  You can use this
  222. #    to force the recipe line to be executed by a shell, in addition to the
  223. #    test used for .SHELLMETAS.
  224. # 
  225. #    To make the '+' fit into the dmake mold, a new attribute has been created.
  226. #    the .USESHELL attribute forces the use of a shell for the target or
  227. #    recipe group for which it is specified.  If it is specified as a global
  228. #    attribute then all recipes executed will use a shell.  The macro variable
  229. #    .USESHELL corresponds to the special target '.USESHELL :' in the same way
  230. #    that .IGNORE corresponds to '.IGNORE :'.
  231. # 
  232. # -- Added *= and *:= macro assignmen operator, patches from 
  233. #    Piercarlo Grandi <pcg@compsci.aberystwyth.ac.uk>, see the documentation
  234. #    for more details.
  235. # 
  236. # -- Changed makefile.mk to force use of a shell (via '+') to make OBJDIR,
  237. #    doesn't break on baren DOS systems that way :-).  Many other small changes
  238. #    to msdos and unix versions of various config.mk files.
  239. # 
  240. # -- Added two new macros related to diversion file processing.
  241. #    See the TEXT DIVERSIONS section of the man page for an explanation of this
  242. #    functionality.
  243. # 
  244. #         TMPFILE - is set to the name of the temporary file whenever
  245. #                   a temporary file is opened by dmake.
  246. #         USESHELL- It's value is 'no' if the current recipe line is not forced
  247. #           to use a shell via a '+' or .USESHELL directive.  It's
  248. #           value is 'yes' if such a directive is given.
  249. #     DIVFILE - is defined in startup.mk and gives a macro to use to set
  250. #           name of the diversion file, (under UNIX, DIVFILE defaults to
  251. #           $(TMPFILE), under MSDOS it is the value of $(TMPFILE) with
  252. #           any / replaced by the appropriate number of \ depending, on
  253. #           if a shell is used or not).
  254. # 
  255. # -- \\ appearing at the end of a line does not cause a continuation to the next
  256. #    line.
  257. # 
  258. # -- Modified the definition of macro supplied from the command line to allow
  259. #    macros defined using += or +:= to be modified further from within the
  260. #    makefile.
  261. # 
  262. # -- Added MAKETARGETS macro which contains the name of the target(s), if any,
  263. #    specified on the command line.
  264. # 
  265. # -- Modified Pack_argv in sysintf.c to use dynamic memory allocation rather
  266. #    than limit it to a fixed number of arguments.
  267. # 
  268. # -- BIG BUG FIX:
  269. #    This one is cute.  It turns out that all individual recipe line
  270. #    attributes supplied via '@', '-', and now '+' and '%' characters were
  271. #    getting or'ed together and applied to ALL recipe lines of the recipe, yulk!
  272. # 
  273. # -- BUG FIX:
  274. #    Fixed off by one error in make.c:_print_cmnd when remapping \n after
  275. #    printing the text.
  276. # 
  277. # -- BUG FIX:  Bug reported by holos0!lbr@gatech.edu
  278. #    Inferred prerequisites were not getting made when a target was found to
  279. #    be out of date relative to a non-inferred prerequisite, and the inferred
  280. #    prerequisite did not exist but the file it could be made from did and was
  281. #    not out of date relative to the target.  This was a problem with the
  282. #    following setup.
  283. # 
  284. #         file.o : header.h
  285. # 
  286. #    File system contains file.o, header.h and RCS/file.c,v, If file.o is newer
  287. #    than RCS/file.c,v and older than header.h, then dmake didn't check out
  288. #    file.c prior to doing the compile.
  289. # 
  290. # -- BUG FIX: Applied patch from UUCP: twc@legal or ...sun!ys2!legal!twc
  291. #    to msdos/_chdir.c to fix changing of directory in OS/2 protected mode
  292. # 
  293. # -- BUG FIX: Applied patch from UUCP: twc@legal or ...sun!ys2!legal!twc
  294. #    to msdos/switchar.c to read environment variable SWITCHAR instead of using
  295. #    unsupported call in DOS.  OS/2 doesn't have _get_switchar call!  (It damn
  296. #    well should though!  Microsoft is really dumb in this respect!)
  297. # 
  298. #    Extended this patch to use SWITCHAR environment variable in all DOS
  299. #    versions.  This ensures that DOS 4.0 can selectively change SWITCHAR by
  300. #    using the environment variable.
  301. # 
  302. #    Dmake now first gets SWITCHAR from the environment and if that fails it
  303. #    tries the unsupported MSDOS call.  Under UNIX getswitchar returns '-'
  304. #    as before.
  305. # 
  306. # -- BUG FIX: Changed the line _ar.ar_size = atol(arhdr.ar_size) found in
  307. #    ar_scan() in arlib.c to not use atol() if ASCARCH is FALSE.  I forget who
  308. #    reported this one :-)
  309. # -----------------------------------------------------------------------------
  310. exit 0
  311.  
  312.